home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / INTERNET / SITES / GRAHAM / XAAES_S.ZIP / XAAES / DOCS / USERGUID.TXT < prev   
Encoding:
Text File  |  1996-05-06  |  6.0 KB  |  174 lines
  1. XaAES User Manual
  2. (W)Craig Graham (c_graham@patrol.i-way.co.uk)
  3.  
  4. 1) INSTALLATION
  5. -------------------
  6.  
  7. Installing is pretty easy, just do the following:
  8.  
  9. i) Stick these files all in one directroy:
  10.    xaaes.tos   - The kernal (colour & mono versions are in seperate archives)
  11.    xaaes.cnf   - Like GEM.CNF, but for xaaes.
  12.    moussrv.tos - the mouse handler
  13.    moose.xdd   - The mouse device driver
  14.    logo.prg    - the XaAES logo, (possibly) launched at startup.
  15.    system.rsc  - various GUI elements for the kernal (default menu, alert template, etc)
  16.    sys\toswin_w.tos  - The usual toswin console.
  17.    sys\TOSWIN.RSC    - resource file for the above.
  18.    sys\rt.tos  - runtos
  19.  
  20. ii) If you want a console shell (the xaaes.cnf file is set up to give you one),
  21.    you should edit the xaaes.cnf file so rt runs your fave shell (I use sh, but
  22.    mupfel, etc will work as well).
  23.  
  24. iii) Add these lines to your MiNT.CNF file:
  25.  
  26.       cd u:\<path>
  27.       INIT=u:\<path>\xaaes.tos
  28.  
  29.      Alternatively, if you are a bit more of a techie, XaAES will run happily from
  30.      a command line (and let you exit back to it) or as a login shell.
  31.  
  32. iv) Copy the mouse device driver 'moose.xdd' to one of:
  33.     c:\multitos
  34.     c:\mint
  35.     c:\
  36.     Your auto folder
  37.  
  38. Ok, thats it.
  39.  
  40. 1.1) COMMAND LINE ARGUMENTS
  41.  
  42. XaAES only has one command line switch, which sets the video mode for falcon users:
  43.  
  44.          -video <mode>
  45.  
  46. where <mode> is:
  47.  
  48.       0 = 80 column, non-interlace, mono
  49.       1 = 80 column, non-interlace, 4 colour
  50.       2 = 80 column, non-interlace, 16 colour
  51.       3 = 80 column, non-interlace, 256 colour
  52.  
  53. These don't work very well at the moment, but do get round the NVDI2.5 problem.
  54. If you are using NVDI on a falcon, and you get a black screen on starup, try
  55. starting XaAES with:
  56.  
  57.             xaaes.tos -video 2
  58.  
  59. - this should sort you out (put's it into 16 colour mode at startup).
  60.  
  61. NOTE: If you are using an ST with a colour monitor/TV, holding down either shift
  62. key whilst XaAES loads will select medium rez instead of low.
  63.  
  64. 2) Using XaAES
  65. -----------------
  66.  
  67. 2.1) Menus
  68.  
  69. Generally XaAES is like GEM, but with a few exceptions. Most notably, menu's are
  70. Mac-style pull down, not GEM style drop down. This means that you've got to click
  71. on a menu title to see the menu, not just point at it.
  72.  
  73. Also, holding down CONTROL and clicking on the menu bar will 'Tear-Away' the menu
  74. bar, allowing you to have several menu's on screen at the same time.
  75.  
  76. 2.2) Typing
  77.  
  78. XaAES can be point-to-type - so keyboard input goes to the window under the mouse and
  79. NOT to the top window. This depends on compile time flags - check the boot message
  80. to see if this feature is active.
  81.  
  82.  
  83. 3) XaAES Keyboard Combo's
  84. ----------------------------
  85.  
  86. There are a couple of keyboard combo's that XaAES uses for itself. These are:
  87.  
  88. CTRL+ALT+TAB     : swaps menu bars, not top windows.
  89. CTRL+ALT+L       : Output a list of current client programs to the debug file
  90. CTRL+ALT+D       : Output a status dump to the debug file
  91. CTRL+ALT+K       : Clean up - search for dead clients that didn't call appl_exit
  92. CTRL+ALT+R       : Attempt to recover control of a hung system - use as a last resort,
  93.                    as this will kill the clients that are blocking the system.
  94. CTRL+ALT+C       : Shutdown immediately, killing all clients.
  95.  
  96. NOTE: CTRL+ALT+L & CTRL+ALT+D only output anything if GENERATE_DIAGS was turned on at
  97. compile time - in the binary distributions released by me (Craig) they will have no
  98. effect as all diagnostics are turned off.
  99.  
  100. 4) SYSTEM MENU
  101. ---------------
  102.  
  103. The XaAES system menu (CTRL+ALT+TAB until you get it) currently contains two useful
  104. options.
  105.  
  106. One is the 'About XaAES...' option which (surprisingly) brings up a nice
  107. little descriptive box.
  108.  
  109. The other (more useful) option is in 'Shutdown'. This will kill all GEM programs
  110. and exit XaAES gracefully. Unlike MultiTOS, if you ran XaAES from a command line
  111. or as a login shell, you will be returned to the command line or login prompt. You
  112. can then re-start XaAES, or do whatever - XaAES can be exitted and restarted as many
  113. times as you like without rebooting the machine.
  114.  
  115. XaAES catches CTRL+ALT+C and CTRL+ALT+\  (SIGINT & SIGQUIT respectively) and executes
  116. the shutdown procedure in response to them, so you should be able to get back to your
  117. command line in most situations.
  118.  
  119. 5) THE xaaes.cnf FILE
  120. -----------------------
  121.  
  122. This is a bit like MultiTOS's GEM.CNF file. It's main purpose is to let you auto-launch
  123. programs as XaAES starts up. Generally the syntax of this is supposed to be the same as
  124. Atari's GEM.CNF file
  125.  
  126. It's a simple text file with the following format:
  127.  
  128. i)   '#' is a comment line.
  129. ii)  Commands are not case sensitive (although paths may be, depending on your filesystem).
  130. iii) If a command isn't understood, it gets ignored...
  131. iv)  These commands are currently supported:
  132.  
  133.          run <program> <parameters....>
  134.             Launch a program.
  135.  
  136.          debug <file/device>
  137.             Set debugging output to <file/device> (default is .\debug.list)
  138.  
  139.          clipboard <directory>
  140.             Set the GEM clipboard to be in <directory> (default is c:\clipbrd).
  141.  
  142.          accpath <directory>
  143.             Set the location that XaAES will try to load accessories 
  144.             from (default is c:\).
  145.  
  146. And example xaaes.cnf file (in fact, the one I use) is:
  147.  
  148.    #Craig's Setup
  149.    #---------------
  150.    # Set the default clipboard path
  151.    clipboard c:\clipbrd\
  152.    #
  153.    # Where to load desk accessories from
  154.    accpath c:\
  155.    #
  156.    # Launch toswin (68030 version) to handle TOS programs for me
  157.    run u:\h\sources\aes\sys\toswin30.prg
  158.    #
  159.    # Launch the desktop
  160.    run u:\c\thing\thing.app
  161.    #
  162.    # Set Debugging to go to serial port
  163.    debug u:\dev\ttyb
  164.    #
  165.  
  166. x) Caveats
  167. --------------
  168.  
  169. I've compiled  out most of the diagnostics, but if you get funny messages on
  170. the screen, add the line 'debug \dev\null' to the xaaes.cnf file.
  171.  
  172. Loads of stuff is missing at the moment, don't hassle me - fix it and get back
  173. to me.
  174.